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GENERAL DESCRIPTION 


The Supervisory Message Cortrcl System (SMCS) program is intended 
to be the supervisor fcr a data communicaticns software system 
which inctudes such Burroughs software as CANDE» RJE» HASPs SYCC™M 
and other ontline packages of either Burroughs or customer 
origin. SCS also serves as a base which can be easily augmented 
to meet any customer requirements for a specialized or more 
inclusive systems supervisor. 


MAJOR ESATURES ‘ 


SMCS provides ali of the features of the previously reteased 


Illustrative MCS CMCSII) and several new features that 
considerably exoana the flexibility cf remcte terminals. MCSII+ 
for example, previded message switching (terminal tocterminals 


terminal-to-SPQ» SPO-to-terminal)» attachment to user programs 
via aremote file» infcrmaticn about the remote network» and 
internal (MCS) error reporting as some of its basic functicns. 
The new SMCS wili provice all cf these features in addition toa 
allowing users to: 


= Designate’ terminals as remote SPOS and have access to MCP 
commands anc information about the status of the system. 
From terminals designated as unrestricted» jobs can be 
executed as if the remote stations were a SPC. 


- Participate in the basic file security mechanism 
supported by the MCP and spawn jobs in accordance with 
the requirements of file security. Furthermores SMCS 


supports a job file for storing execute instructions that 
are tailored to a particular user's or program's needs 
anc a mail file for storing information that is returned 
from a user program cr a host systems. SMCS automaticatly 
checks the job file fer special execute requirements and 
allows users to check the mail file fcr information that 
is received from a host system. or. ‘an application program 
CPROGRAM~PASS ae aa 


% Pe shes. 
-~ . Altow a user at a _remote. “terminals” thretign the PASS 
- command and = the PROGRAM= PASS message interface» to 
request a functicn Jof ao procram in the host system 
without signing on tothe program. | In this way» for 


examples an edited file may be transferred’ from: the host 
gystem to°'a remote system via the RJE interface uhile the 
Wiser continues to edit ‘another’ eee 


| aS Receive evcanewa retwork | reporting that is tailoréd. to 
/ " andividual remote stations (desigrated,as restricted} or 
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that involves the whole retwork and the operating system 
Cunrestricteac stations). 


. Initiate system tracingr from unrestricted stattons only» 
to take advantage of the debugging facilities provided by 
the B1800/81700 operating system. 


CONCEPTS AND DEFINITIONS 


The following terms are critical to an understanding of the 
structure of the SMCS program and are defired as follows: 


JO8 FILE a disk data file containing a List of 
program names and their associate 
requirements abou.t how they must te 
executece 


#08 SPAWNING the erocess of cre prograts under 4 
usercode» exectting a job (Canother 
program). This implies that the 
security mechanism in the operatina 


system (MCP) will verify the right of 
the eprecgram tc heve access to all tnput 
cisk files that are required and thet 
att output files wili contain secure 
multifile ids. 


MAIL FILE a Gisk data file in which messages from 
a pregram cr the MCP are kept. The 
system of keepirg these messages is 
defined as the MAIL function of the 
SéCS. 


PASS COMMAND a remote command which activates the 
SMCS te send a message to a specifiec 
programs without the remote terminal 
being signec cn. tc that program. 


RESTRICTED COMMANDS iWowerdemmands Ene SHCS allows onty fron 
oo a station which s «designated as 4 
remote SPO Cor control 


er. station). 


SIGN ON <4 the cotmana unten atone terminal to 
“g be attached te a specified pfogram. 


22 USER COMMAND & a eéenand which validates the usercode 


and password and allcws that user to te 
neSces on to the SMCS. 


UNRES£ 


HM CTED COMMARES SMCS. or MCP commands that are allowed 
7 from any station. ~~ ae ip 
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ZIP EXECUTE an execute statement sent from a program 


to the MCP requestince that a job be 
scheduled and run. This method does not 
employ the security mechanism of the 
eperating system. 


REMOTE OPENS 


One of the major facilities provided by the SMCS is the execution 
of application programs which oper remcte files. © The SMCS) aids 
In executing these programs by checking an internat job file>» 
described more fully in. Appendix A» for special instructicns 
about how the job should be executed: Q@eGee Criorityr number cf 
remote stations aiicwear file equaticns» etc. : 


Jobs are either spawned or zip executed. A spawned job invokes 
MCP security procedures by including in the zip usercode and 
session information required by file security. Zip executed jots 
invoke no security procedures. 


There are two forms of executiors one secure and the other not» 
that are allowed ty SMCS. Cnty remote SPOs may use the unsecure 
form of executicn. In accitions SSCS provices a mechanism for 
passing information between remote terminalis and jobs that are 
executed from a remote station. These facilities are definea as 
follows: 


2EXCECUTED 


A station using this method of executicn must be Logged onto the 
system by the USER <usercoce>/<password> syntax. After entering 
2EX <program name>» the specified program will be spauned. No 
reference is made to the job file vanc only the station thet 
initiated the job will be approved in any remote file open coming 
from that joD. - 


SIGN ON 


“A station which may or may not be logged 


a cn enters th® folloxwing 
 Sommand. : ; 


SIGN CN <program name> 

- ; Sy : ee ; x “ : c ry : ie . ie “ zee 
_ If. program name> ts not runrings it wifl be “zip executed “€not; 
.Spa@yfied) -including any specificaticns in the-job file if one is*’s. 
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present. Ali stations (Cup to the Limit declared in 


NUMSER.OF eSTATIONS) enterirg SIGN ON fer that program will he 
approved in the opene If the program is runnirg» its remote file 
is open anc the number cf staticns currently attached does not 
exceed NUMBER.CF.STATICONS cectared in the cpens then the station 
will be attachec. 


I fr at either open or attach time the fite to which the 
station(s) must te attached already has as many stations attached 
as declared in NUMBER.CF.STATICNS+ then a rew copy of the program 
will be zip executed ard the remaining stations marked as waiting 
for that open. This precess is recursive for each open cr 
attach. 


The effect of this method is that NUMBER.GF.STATIONS (NST in file 
equates) in 2@remote file cpen will determine how many stations 
can be hancled ty the procgrar. 


NST 
NST 


1 => 1 copy cf pregram cer SIGN CN 
5 => 1. capy cf program per five SIGN ONS 


| 


At SIGN OFF» the station ts detached from the fite. If this wes 
the Last station on the file» then arn EOF Branch is sent te the 
file Cunless the job fite NC EOF scecificaticn exists). 
Typically» an ECF tranch on a remote file read will cause the job 
to perform a STOP (qo to EQJ). 


PASS 
A station which has been togged on via the usercode/execute 
facility descrited on the previous page enters 

PASS <program name> <string> 
<Program name> -is treated user y: ae in SIGN GN wtth tke 
exception that the station that FASSed? not. approved in the 


opens nor is it attached if the prograe® as, already running. 
a oa - hy ” . 


“SNCS “PHlotes that. this station | has. Tues ait eases to this 
program and later PASSes from this Station will not cause a new 
feapy ‘to be zipreds.  Howeveres PASS. to this procram froma staticn 
vWhfch previously had not PASSed to it will cause SMCS te 
' de®er mune the néec to zip execute another copy dependent upon 


“NUMBERSOF . STATIONS exactly as in SIGN ON above. 


ra 
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When a station enters SYE» it ts removed from the tist of knonxn 
PASSers on the files to which it PASSec. This command is similar 
to SIGN OFF except that no detach is sent. If any of these files 
then have no staticn attached Ceither by PASS or SIGN ON)+-- then 
an EOF tcranch ts sent to the file>» unless the jobd_ file 
specifications KG ECF» existse 


Note; If a program which cpens_a remcte file (such as CANDE) its 
executed from the host SPQ» then SMCS wilt approve its 
open giving it as many stations as it can» disaltowing 
only those stations which are already active through 
SMCS. It is reccrmended that this not be done since the 
SMCS would then have no way to retrieve those stations 
without each one being- explicitly SIGNed OFF. 


Pd 


The SMCS attows fer the cefinition or creation of a station as a 
remote SPO via the MAKE or CHANGE commands or by definition in 
the station section of the network cortrcller. A station is 
considered to be aremote SFC if its frequency (receive) 15 
greater than 249. Gnly a remote SPN staticn Calso referred to 4s 
a controttler staticn) may initiate restricted control statements. 


Three new commands (2» PASS» anc 8YE) are alsc restricted by the 
requirement that the staticr be Logged on under a valid userccode 
and password. 


Name Number 
BL@00/81700 Message Control System Interface Pe Se 2212 S447 
BL8@00/8170C Network Definition penguage Pe Se 2212 5223 
B1800/81700 NDL/Library ~ oe Pe Se 2212 5215 
B1800/91700 Cataconmm Audit Pe Pe. Se 2212 5421 
B1800/B81700 Software Cperaticnal Guide | 1068731 


B1800/817.00.. NOL Reference Manual ae oe ne 1073715 


aes 
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OPERATIONAL PROCECURES 


SMCS contains most cf the basic building blocks which would te 
requireds in one form cr ancthers for a comprehensive MCS. Every 
effort has been mace to keep the SMCS as medular as possible» so 
that changes may be readily effected. The nodularization also 
renders the program a more readable aocumert. 


The, internal file name of SMCS" remote file is “REMOTE”. When 


executeds a file equation may be used to equate "REMOTE™ with the 
desired file name. The external file name expected 15 
*MCSREMOTE". 


Controt messages can be entered through remote stations onrly. 
The syntax is shown betow: 


Syntaxs 
en ee *HlS-sSocseroeSURrestricted centrcl staterent=—--= >t 
le-signal character-I ferestricted control statement---1 


Semantics: 


The signal character is “*" unless changed by a SIGNAL command 
and is used to communicate to the MCS when the station has been 


signed on to some cther program. A station with frequency 
(receive) greater than 249 ts considered a centrot station. 
These stations may enter both restricted and unrestricted 


commandss other stations can use only the unrestricted commands. 
Note that any control statement is free-field form. 


Statements; 
“The following are the unrestricted control statemefits?._ 


BROADCAST 
*BYE 
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MAIL 
MAKE. <LSN> (NOT) SCROLL 
#PASS 
READY 
REPORT 
SEND 
SIGN OFF 
SIGN ON 
STATUS 
TRANSLATE 
USER 
+? 


#Station must te logged on under a valio usercode and 
password (See USER com@mard). 


The following are the restricted contrcl statements. They 
initiate a response from the eperating system: 


ATTACH 
CHANGE 
CLEAR 
DETACH 
DUMP 
MAKE 
MOVE 
NEWS 
REMOVE 
SIGNAL 
SYSTEM 
TRACE 
ZIP 


The following 
diagrannatic con 
syntax combina 


command descriptions make use of a simple 
yertion for displaying ail the possible vatid 

ce Uppercase/lLowercase letters» in addition to 
cters listea ‘bellows are used to indicate 
syntax. Uppercase mgaans required? lowercase 


gs part. The. ‘abbreviation. Sp the 
5 i Pee If net present» there 1% no 


wm 
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Examples: 


ee Zt TP erent 


MCAKE )ocerroe Lsntttr tet ecccscerere onsen e READY ct e+ 3++>- >4 
{t----station namern~oer-> { YrrNCTrw-d Fer ENABLED--] 
t----usercode of LO cers 
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COMMANDS 

AITACH 
DETACH . 
Syntax: 
wmm—mATICACH) ee ee SF Fae EZ anna ann ame eae w ew oe ee > 
I--TC----1 bo f--PROGRAM@<I--jcb number---------- 
I="DETCALH) S11 <= <S 225s 1] Jj-"-program namew--71 j 
L="F ROY] | i 


{~"FILE*e*"rr"lo-rremcte file number--1 
is-remote. file name--! 


i aa a a a ae a ae a ei a ie oe snore rer er en ser eee resem eee nena eeeen >4 
P-~-STATION<--1 f---station name~-1 jw » ==] i 


semantics: 


Both commands are valid from alt contrctler stations. See SIGh 
ON and SIGN OFF for normal station=to~station attachment. 


ATTACH and DETACH commands are used to add or subtract stations 
from a given remote file... 


Thesa commands are usec to medify a given remote file staticn 
list. The stations tec be adeced or subtracted must follow the 
rules set up in Fe Se 2212 54475 MCS Interface» for the ATTACK 
and DETACH messages. oe 


_ Ue Fy 


As a program name is used» then the first remote file in the 
‘Pemote file table cf.SMCS is the. subject of these commands. If 
no program or file is specified» then the station Is attached Cor 
| Aigtachedy. to (from) SMCS*s_ temote Fi1e. 


PROGRAM EDITOR 32405 °° 
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BROADCAST 

syntax: 

pecweuawie == BROADCAST coo eee ewwmeronessagercen renee nn nee eeann- >I 


Semantics: 


The BROADCAST command sends a given message to all SMCS staticns. 
It is equivalent to the “SEND TO ALLi<message>" and is valid from 
alt stations. 
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Semantics: 


This commard logs the current user off SMCS. 
the host SPO. 


ail stations except 
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It its valid frona 


If the station sending the 


command 1s the Last currently active staticn and a STOP command 


has previously been enterecs 


SMCS witl terminate after processing 


. the 3YE af the station was markec as havirc PASSed to a2 remote 
file and this is the onty Cor tast) station marked. 
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CHACNGE “STATION @----Lsnewnnnse TRANCRECEIVE torr n nin nm--<variacte>- 


i-stat-narnrel 


For <variatle> vatue format cn the CHANGE messager 
2212 5447.5 MCS Interface. 


Semantics: 


The CHANGE 


1“ TRANCTRANSPIT I~) 
P"ADDRESSCRECEIVE --=$ 
P“AQDRESSCTRANSMITI<~{ 
PrFREQUENCYCRECEIVE D1 
I-FREQUENCYCTRANSMIT DI 


1-TO-1 


fSRL VR Yor er er ec es ees i 

TeRETRIES SA SoS = Sas | 

PePHONE SA "0343s 5245> t 

i 

i-ENASLEC@ ee == Se (ees ess ate = 

ae a a “1 CFF ee e4 

{-CIAGNOSTIC~---- 1 f==[RUGE=-4 

PeLOGICALACK*3“-= i “FALSE SA 

I~ COQDKRESULTS<----!2 ea Vaated | 
bees Ces= 1 
see P,. §& 


command is valid frem alt certroltler stations and is 


used to dynamically change various NDL station attributes. The 
NDL attributes are changed approrriately tc the new value. 


Examples: 


CHA 5 PHCNE 123°4567 


CHA STATION ST2 READY CK 
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ELEAR 

Syntax: 

meee CLEARmerF[L Ecotec erere----rencte file rumberco-c cess reo =- >4 


[-e-=*rercte Tile cane---~1 
Semantics: 


ELEAR is vakid from all centrolter stations. It disables flaaos 
 gjndicating the file is waitirg fcr a resperse. Whenever a file 
state is waiting for external response (such as attach reply - 
see Pe. Se 2212 5S447e MCS Interfacede and the f¢rogram responsible 
for the response does not respenea (O0Sed cr prosran error),s one 
should invoke this command te reset the file status. 
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DuMP 

Syntax: 

ed ee ee ee ee DUMP owe mer ww memes ere new awe nen nena anma ems we wee ane > ] 


Semantics: 


DUMP is valid from all contrctler stations and causes SMCS to do 
a DUMP -FOR*ANALYSIS. Tt is used for network and proarar 
debugging. ° 
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HELP 

Syntax: 


oe mmm HELP Dorn ten nen ee cee ene renee nce nn ee eon e eee nnn --->] 


Semantics: 


HELP is valid from atl stations. It initiates a display to the 
user of all commands valid fer that statior. 
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JOBS 

Syntax: 


weet enon IC OBS) torn t tence erece- a latetahtatetataatataaateetatetetatatate tate >I 


Semantics: 


This command is valid fror ail stations. It returns informaticn 
about alt jobs tn the host» both active ana scheduled. 


J08S atlows a noncontreller staticn to cbserve the tctal 
activity on the hoster not Limited by the security imposed by 
usercode. Since this is a passive» unsectred MCP ccmmunications 
tt wilt not attlow the rnern-contrctller station to affect the hest 
activity. This facility car be cf use in ceciding whether or not 
the system will bear another job. ; 


SNCS effects the JOBS commanc by sendirg tc the MCP the foltcwings 
commands in succession: 
WY 


WS= 
ML 


The responses will be from the MCP. 
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MAIL 

Syntax: 

weerM( ATL Jrmre- er ee ee eee ee sea wesnurneasmanaenaer trauma ae mows = a >] 


Semantics: 


MAIL is valid from all staticns.« The fermats and responses are 
Shown below. See Arperndix 8 £=xfor an explanation of the mail 

systame 

MAIL Returns current mati count for that station. 
If the station is the hcest SPO» then the 
total MAIL file ccount is disptayea. 

MAIL <ID> Returns currert mail ccunt for <ID> if it is 
fogged on. 


MAIL <ID><STRING> Sends <STRING> to <ID> if Legged cn. 


Z—41C 
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MAKE 
Syntax: 
TAP ONAKE Meese esas Sse a eer ea hae octets ENABL EDS Sesser eeeee ees >I 
P--STATICK=-~1 {--NOT<--! lK"READ Ys ss eee 3 see { 
f--SPOeeset eee eeeee { 


1--SCROLL REVERSE~-! 
Semantics: 


“The MAKE command achieves the same effect as using the CHANGE 
command to change 2 subset cf the staticn ettributes. It changes 
whatever station attribute is specifiec by the user. 


Specifying ENABLED i385 valic from all controller stations. Tt 
Will send a CHANGE reouest to the network controller to set 
STATION-ENABLED to 0 if NCT is specified. Otherwiser it will set 
the attribute to l. 


READY is atso vélid from att controller staticns and sets 
STATION.SREADY to 9 Af NOY is specified. Otherwiser the attribute 
is set to l. 


SPO is a valid attritrute change from alt centroltler stations. 
This request initiates an attempt to send @ change reaquest to the 
network controller for STATION to set FRECUENCYCRECEIVE) to 2Z5C. 
If no nore remote SPCs are aitcweo» then a message is sent to the 
terminal to Inform the user of this restrictior. 


SCROLL REVERSE is vatid from att stations»s but the station 
specified must te that of the recuestor. The station must not te 
in forward scroll mcede. 


Note? Forward scroli mode is disabled by entering "?-" at the 
station. 


SCROLL REVERSE causes ail input from att stations Cand the 
responses) to be scrolled down in the follcwing .manner. 
Pe sa ; a 

Ga 


1., Input is received by SMCS. 
fee ~~ ° 
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2s Cursor is positioned at Left margin cf third 

3, Line jnsert is performed (This scrcetls dewn 
screen). 

4, Input is then rewritten cn the third line. 
to maintain a history on the sereen of ingut 
output.) 

5+ Cursor is positioned at home. 

6- Output is sent by SMCS. 

7, (Cursor is positioned at left margin cf third 

@&, Line insert is perforrec. 

9- Output 315 written. 

10. 


Cursor is positioned at home. 
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CThis echo is 
and associated 


line. 


set 
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MOVE 

Syntax: 

~"-MOVCEVt~--<nunber WA = oe me we eee we mmm ene we wn eee een nenl gn = 2 we @ > 


Prom etALL wee] PMP ROMMMK9 PK STATION“<“!3 Lestation namne--! 
f=--DNESso= 1 


Sa Se ae eS SS ee | ++s== as ea arian! Prem Ls ne ret sees cose e nese ens >1 
l--TC--] §--STATICN~~2 Il--staticn name-~{] 


ef 


Semantics: 


MOVE is walid from ali contreiter stations and enables a station 
to reroute MessageSe It re~queues the output of one station 
into the output queue of ancther. 


S313 


BURROUGHS CORPORATICN COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GRCUP B1800/B17C0 SMCS 
SANTA BARBARA PLARAT Pe Se 2219 O482 CA) 
NEWS 
Syntax: 
Meme N (ENS Poe pater cee eee ee cr eeene otal aiedl ieahakateleietetetertateietetetetetel cent ewe we=>j 
I--- - (minus signjdecr*-"->] 
f---<string o-s7+-" seeeeee> | 


Semantics: 


This command is valid from alt centroller stations. It displays 
or changes the message displayed when a staticn togs on. If no 
option is supplied» the current news message is displayed. If 
"=<" (minus sign) is supplied» then the news buffer will ce 
cleared. If <string> is supplied» then the news message is 
changed to <string> anc cdisplayea. 


Examples: 


Input: NEWS PACK CC 1S NOW CNLINE 
Response: NEWS: PACK CC IS NOW ONLINE 


Input s NEWS = 
Response: NEWS BUFFER CLEAREC 


Input: N 
Response: AEWSS <current message> 
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PASS 

Syntax: 


SSeSSSeS=P CASS VS =-sprogr ak. Nane= 9S ==<<s tring? sTe Ses sserssr sa FI 


Semantics: 


This commana is vatid from ait stations except the host SPC» 


however» the station must be logged on via the US command. The 
<PROGRAM NAME> may either cre found in the known programs table or 
Zip executed and initialized in a table entry. The <STRING> 1s 


Saved if no entry is founc. 


<STRING> is passed by a PROGRAM“PASS messace» depending upon the 
protocol.type in the open received from the program <procran 
name>. See Appendix C. 


Type 00 cutput messages wiil be sert directly to the station. 
Type 60 output messages will be sent tc the SMCS to be routed 
according to infermaticn centained ir subfields in the message. 
(See Appendix C of this preduct specification.) 


The purpose of the PASS command and PROGRAN“PASS message 
interface is to ailow an operator at a terminal to request a 
function of a program in the host system without signing on to 
the program. In this wayre for example» an edited file may te 
transferred from the host system to a remote system vita the RJE 
interface while the operator continues to edit another file. 


Example? 


“PASS RJE «LOG 
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READY 

Syntax: 

Setabaaietetenteteie READY <LSN>e eon nnn nnn n cen nn ee ene nen eee eet 


Semantics: 


READY ts valid from ail stations. It causes a change request to 
be sent to the handler for <LSN> READY to be Set to l. 


At 80J,» all stations are assumed te be online. Notification from 
the network contrcller that a station is.-not responding will ce 


displayed during the MCS initializatior stage. If a station 
becomes resoonsive or aready fer that station is entered» it 
will be marked cntine. when any previcusly cntine station is 


reported as not respendirng ty the network ccntroller» the MCS 
displays “STATICN <LSN> IS CFFLINE"™ at the host SPO and the 
station is marked offline. 


The effect of this system is that the host crperator can attempt 
to make a station ready anc cbserve the stccess cr faiture o f 
that attempt. 
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REPORT 
Syntax: 


wre ne RCEPGRT meen rere een e ner nenene  alatatstahatatetatetatetetatetenstatabetet ol 


Semantics: 


This command is valid from all staticns. It displays information 
about ald known stations. 


Example: 


LSN 2: JOHN SIGHED ON TO CANDE 
1 STATIONS ACTIVE (7245.2 T/17/77) 


LY 


If the requesting station is a centreller» then more information 
is provided. 


Exanple: 


LSN 3CSPG)> CONLINE) 

LSN 12: SIGNEL CN TC CANDE 

LSN 17:2 JOHN CCNLINE) 

3 STATICNS ACTIVE €72345.2 7/17/77) 
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REMOVE 

Syntax: 

“REMC OVE Je" -<cnumcer Pete er eer ewe me wan wee mamas — oe on oe isn a oe oe a ow >] 
peewee ALL were { ler ROMe eS): VRS TATIONSNS4 d==station="4 
Pocono ONES ene I name 


Semantics: 


a 


This command purges part or alt of the cutput queue of a given 
Station. It is valid from ali centroller stations. 


rele 
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SEND 
Syntaxt 
trerSENDecee ern ersten arn ae ALLoo-cece= owe ewww awe -2<message>-->] 
ieTO--] l=-SPUs==<+< 80 SS a a ay eset Se me > 
(eee eses=2sso5 is<nunber >>] 
1 I-STATION="1 I-<narmer--->] 
[<eareneeewne cas Se Aas See eee i 


Semantics: | 


The SEND statement is used fer sending messages and for message 
switching. A message may be sent to atl stations on the network 
ar to a select few. The stations are specified by their NDL name 
or by their LSN. 


SMCS queues messages for the appropriate staticn and sends an 
ecknowledgment (€i.@€e.5 MESSAGE SENT) te the originating station. 
The acknowledgment does not imply that all stations received the 
MESS AGL It merely signifies that messages were queued (for 
eutput for the relevant stations. 


Examples: 


SEND ST32 HELLO 
SEND 2 3 3 HELLO 
SEND TO STATION ST52 HELLO 


HELLO is sent to station ST3 and te LSNs 2 and 3 and STS» respectively. 
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SIGNAL 
Syntax: 
me es m2 wea oe “SIGNAL «one Character ert eves ce cece weno eocacas meme ew >4 


Semantics? 


The SIGNAL commande valid from controller stations» provides the 
user with the ahitity to change the Signal character. 
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SiGN ON 

SiON OFF 

Syntax; 

SLIGN) SSO steerer ener Spr cata: 10a Sees ee eee see es Te ees ->1 
{ P-PROGRAM<1 Ir jecb numberwn] Ier<string>t-ereer> i 1 
| {--PARTICIPATING<-->1] J 


t= OF Fens eceee- siatathetetahetetetahetetenatatataetatatanalstneeetetatanate eletaieiaiaie > 


o 


Semantics: 


SIGN ON and SIGN CFF are valid from all stations except the host 
OPCs 


The SIGN ON control message permits a station to attach itseaif to 
auser program. A staticn can be attachec to onty one non-MCS 
program at a time. (Note: A station may be attached to several 
MCSs.) However» a user program may have several stations attached 
to tt at the same time. 


When SMCS receives a SIGN CGN message it gces through its procran 
tables to determine if the pregram under ccnsiceration has been 
initiated. Then it takes the follcwing action: 


1. If the program has not been initiated» then SMCS executes it 
through a zip command and makes an aprropriate entry in its 
program table. When the program comes into the mix it 
should open a remcte file. This open is received by SMCS. 
SHCS then attaches all stations that were waiting to sign cen 
.to this program by apgercevinge the remote file open for these 
stations. The staticn then receives an acknowledgment 
message indicating that it is signed cn. 


Ze If the program has been initiated but the remote file open 
has not been receivec» then SMCS Lirks this station to the 
other stations waiting for the open cf the given program. 


30 If the program is currently executing and it has opened 4 
remote file» then the station is attached to that remote 
file by an attach command sent to the network controller. 
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The station then receives acknewledgrent indicating that it 
is signed on. 


White a station is signed crto a user program» it may not sign on 
to another programe Alt messages enterec from a signed on 
Stations except fer those which begin with a signat character» 
are sent directly to the user program. Those messages whicn 
begin with a signal character are sent to SMCS. £ALL messages 
written by the user pregram are sent te its stations. 


To detach itself from a user program» a station must do a SIGN 
OFF. When detachment. is comrlete the station receives an 
acknowledgment that sign off is complete. At this point the 
Station will be at the same status as it was prior to its signing 
One The user program wilt receive an ECF brarch from SMCS 
whenever its station count is zero Cie€er no stations are signed 
on to it and no stations which have PASSed are stili logged on to 
SMCS). 


The optional <string> in SIGN ONe if supplieds will be sent to 
the program which is being signed one An example of the use cf 
this facitity woulc be: 


SIGN CN CANCE MY/USER 


which would cause the station to be attached to CANDE and the 
input MY/USER queued to CANDE. If this 1s a valid usercode and 
password combination» then CANDE wilt loo the user on 
immediately. 


The PARTICIPATING option specifies that an MCS should handle 
every message in and out of the signed-on program. “It has ne 
function in the SMCS but is previded for users in the field who 
wish to modify their own message centrcl systems. 
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STATUS 
syntax? 
SESTACTUS ) ee err ae eter er Se ee eee == one ee ee Oe Re ek > 
| I= STATTION-=1- peelsn tt sseetenccen waamaa> | 
L I--station rameserrrerre= >4 
j le=user tide*“e7eecsce"" a=->! 
i | 
Per PROCGRAMce te eee ] cement mene es eee eee >| 
t _terjob nugbereerrerre= I | 
1 le-preogramr ramecrtcrccc?- { ! 
| | 
LeeF ILE «ses <3 <= Les eSese= eS ie aS Se >4 
fe-remote file rumber-| 
is<f3 Le nares" 74"4> | 


Semantics: 


The STATUS command is valida from all staticns. It is used ta 
determine the current status of a programs a file or a station. 


le A STATUS PROGRAM command returns inforraticn an the fotlcwing: 


Program name 

Program jot number 

Remote file name ana number 

Remote file status (Copere not opened) 


22 A STATUS FILE command returns information cn the following: 


Fiie name 

Remote file number 

Open type 

Current stations 

Max stations permitted 
GOOORESULTS CK cor OFF 

SNCS control 

Protacol type and NO ECF status 
PASS log 


3. A STATIGN status command returns irforsaticn on the following: 


Logical Station Number CLSN) 
Station name 

SIGN ON status | 

Program attachment Cif any) 
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SNCS attachment Cif any) 
Signal character Cif ret default) 
The value of the fetlowing NOL station attributes: 


READY 

ENABLED 

TERMINAL TYPE 
BUFFER SIZE 
MYUSE 

ADDRESS 

TRAN NUMBER 
PRICRITY 

RETRIES 

CUTPUT MESSAGES 
LOGICALACK 
DIAGNOSTIC RECLEST 
GOCE RESULTS 
PRIMARY FILE 
SECCNCARY FILE 
PHONE 

CURRENT LINE # 
NUMBER CF LINES: 
LINE IAFCRMATICA 
TRANSLATE 

AUDIT 


Note: The default for STATUS is STATION» which then defaults tc 
the requesting LSN. If PROGRAM cr FILE its specified 
without a program rawe or a filenaree then the program or 
file to which the recuesting LSN is attached is assumed. 
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siGP 

syntax 

cece ererre re STOP eet ee reer ewer erm eessae sews awawe Sarasa anew ouwmma ae = } 


Semanties? 


The STOP command is valid at the host SPO cniy. It prevents any 
further log-on» sign-on» attach» pass» or any other active 
conmand. 


A message is sent to all users requestirg that they tog-off. 
After sending the messager SMCS will attempt to terminate every 
30 seconds or will terminate immediately when the last user logs 
off. , 
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SYSTEM 
Syntax: 
Sa SYSCTEM) cee J ete c et ance semen ane sesame enn en ease assaman> | 
t-s" = (minus sign)--! 
PeAESEO UN Glee Ser ' 


Semantics: 


SYSTEM is valid from ail controtler stations. When entered with 
no optionse the current system id is displayed. If entered with 
the “=" (minus?) cretion» the current system id is cleared. The 
<string> option causes the system id to be set to the first ten 
cheracters of <string> anc cisplayed. 


The system id» when sete wittl be displayed in the LGG ON message 
returned in response to I0 cr USER commands. 
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TRACE 
Syntax: 
wceawmomwrr rt TRACE tt eee her ee er re EH RE RE em san ware WE ee we Oem em >1 
Ire[Or=nt 
jerCR rer] 


Semantics? 


TRACE starts a 
written cy the 
stations. The 
and outputs. 


printer trace of alt data that-is either read or 
SMCS remote file. It is vahkid from all controller 
IG option initiates tracing all remote file inputs 
If no option is specified» the an interpreter ccde 


trace is initiated. The OFF option causes tracing toe be stopcec. 
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TRANSLATE 
Syntaxé 
wewneerenTRANCSLATE ) erm e renew emenne cen enncene — an no we me Sr >4 
Ie-CN-="1 
[--CFFo-1 


Semantics: 


TRANSLATE» vatid from all staticns» is used to force ail lcwer 
€ase eharacters in the input to upper casee The OFF ogtion 
disables the transtate facility. No option specified is 
equivalent to specifing Oh. 
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USER 

1D 

Syntax: 


I--conmanca-~] 


awewe |] D--"“<identifierresserserrsr es wcew sean semen ewe sm morwos aeawe awa >I 


t--cormand-7! 
Semantics: 


These commands are valid from ali stations except the host SPC. 
After being entered» <usercede>/<passwnord> will be validated ana 


then used on alt MCP (€?) ccmmunicaticns. <I[dentifier> or 
<usercodeo>/<passworc> witl be storeac ard used (for station 
identification. The command is optional; howevers +f 7t 1s 


supplied» it will tbe taken as a normal input to the SMCS after 
log-on is complete. 


If either <userceder>/<password> or <icentifier> is atready 
logged-on» the current log-cn attempt will be altowed. The new 
station will be advised that cther staticrs are already togaed-on 
under the same <IP> or <US>. Alt messages directed by usercode 


or id wilt go to atl staticns having that usercode or id. 
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ZiP 

Syntax: 


PEPER Re Ere newer nmamawn est rj ng Permawrecawoamanwawwn seman owen wm aan a = > 


eeee 7 (TP) se-7] 


Semantics: 


ZIP is vatid from ali controller statiors except the host SFC. 
The command may be abbreviated as Zr» however and ts opticnal. 
<String> is sent to the MCP and any response from the MCP is sent 
to the terminal. 


This command is supplied to enable the user to send MCP strings 
which begin with a valid SMCS command such as US. 


Any input from a controlter station which 1s found not to be 6 
valid SMCS command is passea to the MCP automatically. 


<String> will not be secure» meaning that it may reference any 
job in the host mix which is not a "REMOTE" job~« <A remote job is 
one spawned by some program causing it tc have ae session 
assigned. Thus» if auser cn a none-centretter station betongince 
to SMCS enters “EX CMPALL™» that job wilt be a remote job. Any 
attempt to affect that job from a controller station will ce - 
denied by the MCP. Only the host SPO may affect remote jobs. 


Examples: 
EX DMPALL 


ZIP US ME/A EX CMPALL 
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Syntax: 


eee em e me Prem mewane string tts sss eee 2 a ow re eee eee Se =<~->] 


Semantics: 


This command is valid fram ait stations except the host SPQ. To 
use it» the station must tbe tlogaed=con via the US command. 
<String> is zipped to the MCP with tcwusercode/passuord and 


<usercode index> as session for response. 


<String> will be secure,r meanirg MX witt return the user's mix 
only. 


BURROUGHS CCRPCRATICN 
COMPUTER SYSTEMS GRCUP 
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If a file exists named SMCS/J08S» then it is used to execute joks 
under certain suppliec specificaticns.e The file contains date 
concerning a particular job to be run tn cooperaticn with the 
SMCS. When a SIGN CN or PASS input cecmmand occurss SMCS will 
check the information in the jcob file for any cefautts» special 
needs» etc. before executing the job. 


The job file is a cisk data filer each physical record consisting 


of 80 characters,» one reccrea per bleck. Each logical entry in 
the job file censists of cre or more physical records having the 
following formats. The first recerac of an entry is the ID 


“record. 


Length 
Field (CCBCL PIC Forrat) 


Program Name X€32) 


Usercode and XC€21) 
Password 


NO EOF X 


Descripticn 
If this field contains a question 
mark (€?) or 20023 (@ bits» all zero)>s 
then the record is expected to tea 
fermattec as an 1D record. 


For 1D records onlye This is the 
pregram rame for this entry. The 
name 1s in literal ferm containirg 


‘slashes (/) where recessary» left: 


justifiec in the field. 

Exameoles: 

CANDE (first 5 characters} 

TOSOOZEDIT Cfirst 10 characters) 

USER/SACCCUNT/UPDATE (first 19 
characters) 


For IO recorcs cnlys This is the 
userccde and password to be used in 
executine the job. They are in 
literal form containing a slash (€/) 
if necessaryr left-justified in the 
fielc. 

Examples: 

SPO (first 3 characters) 
SYS/JO08S (first &@ characters) 


For ID reécorcs only. If this fietd 


-contains al (numeral one) then the 


MCS wikt not send an EQF“BRANCH 
message to the job after all sitcned 
on staticns have been detached and 
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FILLER 


all stations having PASSed have 
logged cff the MCS. 


X€25) For 10 recorcs only. No present use. 
Reserved for future use. 


The remaining records ir an entry Cif there are any) are cailed 
string records. 


Field 


ew om me 


String 


The MCS 


entry 


progr an 


Length Description 

X€80) For ron-IO0 records only. Alt records 
foilcwinc an ID record and not 
containing a question mark or eCCa 
in the first character positicn eére 
string reéecoras asscciated with the 
gerevious ID reccerd. They contain 
any MCP control strings desired to 
be incluced in the execution strina 
sent te the MCP for this job. 
Examples: 
FILE CAFDS NAME ABC DISK DEFAULT 
eSW9=1L5 FI LINE NO HARS 
FI REMOTE PTL = 13 


wills at sign-on time or pass times» scan the file fer an 


whose ID reéecore centains a program nane which matches the 


mame requestec C€vta SIGN“ON cor PASS). If not found, the 


program name will be usea as 15-6 If founcs then if the usercoce 
and password fieid is not ctlanks it will be included» precedea ry 


"US". 


tefore the EXECUTE verb. The pregramrt name wilt then be 


appended to tha EXECUTE anc all remaining strirg rececrds (Cup to 
the next ID record) will be appended to the program name. 


Example: 


SIGN ON X/Y => EX X/Y FI L NC HAR; 


ID record - 2X/7Y 
String record = FI L NO ARs 


PASS A/B/C <x> => US CT/PW EX A/B/Cs SWO=1e FILE A DSK DEF 


ID record - 2A/B/C QT/PwW 


String record - 2SWO=1> FILE A OSK CEF 
Notes The job file may be created using an editor or using 


ODOMPALL through the card reader. The file must be @C 
characters per reccrd. Tc use DMPALL» one must supply 
“STREAM™ ane “TERMINATE™* cards in place of “DATA™ and 
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"END", This allows the MCP to pass reccrds with "2?" in 


eelumn one to OMPALL after converting the "?" to 4¢0Ca. 
(This is why the [0 record ts identified by either 7?" or 
a0Qa)- 2 


SAMPLE JOB FILE 


PCANDE CANDE 

PRIJE 
7SW 9 2 3 FI REMOTE PTL = 13 

2SYCOM 4 
3FI REMOTE PTL 13 

2HASP 1 
FI REMOTE FIL 13 


www nen ae Pre r wee we Os o m m e ce mF ee oe ge pe mon oe ne mt fe oo an cee em a Secret eson Gece er oe 
ax & . 
12 3 4 

* FIELDS? 

i - ID 

2 7 PROGKAM NAPE 

3 = USERCCDE/SPASSWORD 

4 2 NO.EOF 


The above sample job file shews four entriese CANDE» RJE» SYCCHM 
and HASP» some of which have asscociatec string records. The 
numbered broken Line at the bottom of the fite is a column 
indicator to aid in itttustrating the clhacerent of each field. 
The *'s and numbers below them show the starting columns for the 
fields. 
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APPENDIX 8 = MAIL SYSTEM 


A file named MAIL/<dayname> is maintaired by the MCS. <Dayname> 
is the name of the current aay. Entries to it will be made when 
the MCS receives: 

~ Standard SPO output for a user 


= PROGRAM-PASS input (tyre 60). 


The file is serials disk» &0 characters per records 9 records per 


block and capable of being read by any program. This attlows = an 
editor such a5 CANDE tc LIST or FIND on the fite or OMPALL to 
create a seoarate file of selected records. SMCS currently 


contains no facility to retrieve MAIL entries (See Note 3, this 
section). 


The format of each mail file entry is: 


Length 
Field CO8CL PIC Format Description 
ID X€10) Message identification as specified 
in PROGRAM“PASS input message. This 
id will rormatly ce a userccde cut 
May be the first 1C characters of a 
program rame in literal form. 
Examples: 
GEORGE {a usercode) 
RJE Ca program name) 
TOBOO/EDIT (a program name) 
RJE/CONTEO (the first 1¢ 
characters of a program name = 
RJE/JCONTROLLER) 


FILLER x Blank 


TIME x(€5) The time of entry of this message to 
the mail file. The form ts HH: *¥ 
where HH is the 2 character military 
hour vaiue ard MM jis the 2 chérécter 
Minute value. 


FILLER X Blank 


McSSAGE Xx€63) The message (left-justified in the 
field). Any message tonger then 
63 characters will be broken inte 
63 character pieces and placea 
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contiguotsly in the mail file 
with identicat ID and time fielcs. 


Note 1: At BCJ» the file wilt be created if it does not already 
exist. If it exists» it will be opened and spaced to ECF 
where new entries will be made. when 8192 records have 
reen written to the files it will be closed tock and én 
attempt will be mace to create a new matl fitie named 
MAIL/TODAY. If this file already exists and is dated 
today or has been opered by sore other programs then S¥CS 
wiilk display a message infcrmirg the operator of this 
condition anc wiil rot write any messaces until the file 
is released. 


Note 2: At midnighte S¥CS witt automatically close its current 
mail file Leck and cpen a new cay'ts files Note that this 
ailows six days* previous mail files and today's full 
file>, plus an cverfleow file (C(MAIL/TODAY) to exist 
Simultaneously. 


Note 3: Currently» SMCS only makes entries to the fite» there is 
no mechanism to remceve them cther than the automatic 
removal of the entire file after seven days. The process 
of removing entries is sufficiently complex Cif it ts toa 
provide any reascrable set cf user~specified operations 
on the file) that it shcultd be performed outside of the 


SMCS. Thea concept of a "Mail Handler™ progran 1s 
suggested as the right way to provide a full, complete 
"“MAIL™ system. Such a procram does not exist at this 


times but nill be the subject cf future enhancements. 
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APPENCIX C = PROGRAMMPASS MESSAGES 
PROGRAMTPASS INPUT FNESSAGE 


Applicaticn program 
Read py: MCS 


Written by: 


Purpose? Trarsfer a message from a program to a staticn 
uncer cirecticn cf the MCS. = 
Format: The wessage consists ef tuc parts: 


- A header (for remcte files with headers) or 
a Key (fer remote files with remote kay) 


- Text 
HEADER FCRMAT 
Length 
Field CCGCCL PIC Format) Cescrirtion 
MESSAGE TYPE 99 . ™60" 
FILLER xX 
LSN _ 999 Logical station number 
MESSAGE TEXT SIZE 9999 Numeric input required 
DESTINATICN REMCTE 
FILE NUMBER 999 The file to which the message must 
be sent (the MCS*5s remote file) 
FILLER X( 37) 
KEY FORMAT 
Fielda Length Descripticn 
RSN 999 © File-relative station numpder 
MESSAGE TEXT SIZE 9999 Numeric input recuired 
MESSAGE TYPE 999 Must be "060" 


BURROUGHS CORPORATICK 
COMPUTER SYSTEMS GRCUP 
SANTA BARBARA PLANT 


FEXT FORMAT 


Sees SF See eee 

Field Length 
SS e232 Pree s es 
SUB TYPE 99 
SUB VARTANT 9 

10 X€30) 
FILLER XCLO) 
SUS TEXT 


XCMESSAGE TEXT 
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Description 


Indicates destinaticn stations 
Indicates nail file destination 
Information used tin determining 
dastination,> 
Reserved for future use 
SIZE = 42) 

Actuat text cf the message 


The 10 field varies depending on sub type as follows: 


SU8 TYPE 10 FIELDS 
rere rws we a oF em we wm ae 
a0 FILLER 
O1 USEREDDE INDEX 
FILLER 
02 REMOTE FILE NO} 
FILLER 
03 USERCODE 
FILLER 
04 PRCGRAW KAME 
05 USER ID 
FILLER 


LENGTH 
PIC 


X(30) 
9999 


X(26) 
999 


X€27) 
X€10) 


X(€20) 
X€30) 


X¥€10) 
X(20) 


DESTINATION 

DESCRIPTICN MAIL Id 
Usercoce cr 
if present* 
Station€s) with Usercoce.« 
this usercode 

index 


Usercode or 
if present* 


Staticn(s) 
attached to this 
remcte file no. 


Staticn(s) 
leggec on under 
this usercode 


Usercode* 


Staticn(s) 
attached to this- 
progran 

Matt cr MCS only 


Program name 


User ID 


*If destination cannot be fcunds then the message cannot te 
mailed or sent to any station. 


The sub yariant fieid indicates speciat -destinetion as follows: 


SUB VARIANT 


Fun Poe sevoawan wm 


Description 


0 Send to destination as specified by sub type 
in mail file 


and put 


Seno to destinaticn onty 


1 
2 Put in wail file cnly 
3 Kho cestiratione 


no wail file. Message is for 


dependent on sut type 


ID 


10 
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the NCS orly. (Procram direct communication 
to the MCS - ro tapterertation as yet.) 


hritten by; MCS 

Read by 3 Application pregrar 

Purposes Transfer a message from a statior under control 
of the MCS to a preaqram. The message is formatted 
according to CFEN.PROTCCOL.~TYPE as specified in 
the program's remote file. 

Format: The message corsists of two parts? 
- A header (for remote files with headers) or a 
key (fcr remcte files with remote key) 


~ Text 
HEADER FORMAT 
Length 
Field (CGBCL PIC Forrat) Descrirtion 
MESSAGE TYPE 99 "61" 
FILLER xX 
LSN 999 Logical station number 


MESSAGE TEXT SIZE 9999 
DESTINATION REMCTE 
FILE NUMBER 999 The file to nhich the message must 
be sent Capplication file) 
FILLER X¥€37) 


KEY FORMAT 


eRBPrrPRreFTe Bw 


Field Length Descripticn 

RSN 999 Filerrelative station number 
MESSAGE TEXT SIZE 9999 

MESSAGE TYPE 999 Must be "061" 
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TEXT FORMAT 


Fer er Fr Pr PPP se 


Jext is dependent upen QOPEK~PRGOTOCOL.~TYPE. 


PROTOCOL TYPE FIELD LENGTH DESCRIPTION 
Co ee ee ee ee Peres a aan nanamnane 
0 {Invalid for PROGRAM<-PASS 


4 


output message. SMCS wiil 
send messages by type "C1" 
instead of "61" when a 
Station PASSes to a progranr 
whose OPENe»~PROTOCCL.TYPE is 
0.) 
i USERCCDE INDEX 9999 Usercode index of user 
for whom this message 
is destined. 
FILLER X€10) Future use 
SUB TEXT XCHESSAGE TEXT SIZE 3-14) 
279 Reserved for future use 
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